home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / rffsrt23.zip / RFFSORT.DOC < prev    next >
Text File  |  1992-03-05  |  7KB  |  167 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                                   RFFSORT                                   *
  13. * Ron's Flexible Fast Sort program, RFFSORT V2.3, Mar 1992.                   *
  14. * Last Update : Mar. 05, 1992.                                                *
  15. *******************************************************************************
  16.  
  17. File List
  18. ---------
  19.  
  20.  This package contains the following files :
  21.  
  22.  RFFSORT.EXE    - RFFSORT program executable.
  23.  RFFSORT.DOC    - This file.
  24.  RFFSORT.REG    - Registration File.
  25.  PROGRAMS.TXT   - ISoft D&M shareware products description.
  26.  
  27. Why Register
  28. ------------
  29.  
  30.   RFFSORT is a shareware product, if you find this product valuable, 
  31.  please register it. This section describes the reasones you should register.
  32.  
  33.   By registering you will receive a printed manual, with many examples, a 
  34.  diskette with the latest RFFSORT version, and the complete source code for 
  35.  RFFSORT, and - you will help us to create the next version of RPTP - that 
  36.  will include even more features then the features that are currently 
  37.  available!,  we might even add YOUR enhancment requests!
  38.  
  39. What's New
  40. ----------
  41.  
  42.   Version 2.3 added the /? help page parameter. From this version RFFSORT
  43.  is distributed by ISoft D&M, P.O.B 5517, Coralville IA 52241, U.S.A. 
  44.  
  45.   Version 2.2 fixes a bug created by TP6.0 that does not create the stack
  46.  frame as needed when compiled with stack check off {$S-}. When RFFSORT
  47.  was compiled with {$S+} every thing works as expected. (Do not ask me 
  48.  why the problem occurs, It is just there!).
  49.  
  50.   Version 2.1 Added even better performance by optimizing the compare
  51.  routine. On my 386-33 a 12K text file was sorted in 1.3 sec., VS 1.6 sec.
  52.  in version 2.0. (This is a 23% improvment!). The 168K fixed record file 
  53.  was sorted in 7.5 sec. VS 9 sec. in V2.0. 
  54.  
  55.   Version 2.0 uses a new combined internal and external sort algorithm 
  56.  in order to gain speed. Sorting a text file of 36K on a 33-MHZ 386 took
  57.  36 Sec. with V1.2, VS. 9 Sec. with V2.0. A fixed record size file sort, for
  58.  a file of 168K took 98 Sec. with V1.2, VS. 9 Sec. with V2.0 !. We can
  59.  assume that files that will fit in memory (up to 500K usually) will be
  60.  sorted in about 9-10 Sec., and only files that are larger then memory will
  61.  take more time. even this time is smaller then V1.2, because of the smaller
  62.  number of passes RFFSORT performs. Please notice - all of these tests were
  63.  done with the work directory set to the current hard disk drive, it is 
  64.  recomended to set the work directory to the ram disk, if available in order
  65.  to minimize sort time. I have ran the text file sort again on a 12-MHZ 286,
  66.  with the workind drive set to a ram drive, and received the following results :
  67.  V1.2 - 27 Sec. VS. 15 Sec. for V2.0. 
  68.  
  69.   Version 1.2 fixed a bug with several ram drives that gave an invalid 
  70.  media error, added count of number of records processed.
  71.  
  72.   With version 1.1 text files can be sorted using the -t switch, text files
  73.  are sorted with a maximum sort line size of the /Lxxxxx parameter.
  74.  
  75. Introduction
  76. ------------
  77.  
  78.   RFFSORT is a sort utility for files with fixed sized records, and text files,
  79.  RFFSORT can sort HUGE files, provided it has enough disk space to hold the 
  80.  temporary files. RFFSORT allows the user to sort the files using up to 10 sort
  81.  fields, that can be in acsending, and descending order.
  82.  
  83. Usage
  84. -----
  85.  
  86.   At the command line type RFFSORT and press Enter to receive a help screen,
  87.  this screen lists the programs command line format, and options.
  88.  
  89.          RFFSORT V2.3, ISoft D&M, P.O.B 5517, CORALVILLE IA 52241, U.S.A
  90.    Usage ..
  91.          RFFSORT [e-options] input-file [e-options] [output-file] [e-options]
  92.    E-Options ..
  93.          @optfile - file of options
  94.          options  - options displayed below
  95.    Options ..
  96.          /Lxxxxx        - xxxxx characters per record
  97.          /Sf,sssss      - Start of f''th field at sssss
  98.          /Ef,eeeee      - End of f''th field at eeeee
  99.          /Of,d          - Order of f''th field is d, where d is A or D
  100.          /Dpath         - Path of working directory
  101.          /T             - File is a text file, with at most /Lxxxxx characters
  102.          /?             - Display help page
  103.  
  104.    Notice - in option files, each option is at 1 line.
  105.           - f Values are 0 .. 9
  106.           - sssss, eeeee in 0..65535
  107.           - d is A = Acsending, D = descending
  108.  
  109.  (*) Points to notice :
  110.         
  111.         A. If you sort a file written with fixed length text strings,
  112.            terminated with the standard dos CR/LF remember to add 2
  113.            to the record length you specify to RFFSORT. 
  114.            (e.i. - the file looks like ..
  115.                 RECORD1...SOMEDATA...ENDOFRECORD1
  116.                 RECORD2...SOMEDATA...ENDOFRECORD2
  117.                 RECORD3...SOMEDATA...ENDOFRECORD3
  118.                 ...
  119.             The record length should be 33 + 2 = 35 )
  120.  
  121.         B. RFFSORT uses a combination of internal modified quick sort, and 
  122.            external merge sort algorithm that works on the storage 
  123.            device, remeber that if your file occupies X bytes on the
  124.            storage device, RFFSORT will need 2X free bytes on the work
  125.            directory to sort your file !
  126.  
  127. Warranty
  128. --------
  129.  
  130.   There is no warranty what so ever, The program is supplied as is,
  131.  The distributer (ISoft D&M), or the author (Loewy Ron), are not,
  132.  and will not be responsible for any damages, lost profits, 
  133.  or inconveniences caused by the use, or inability to use this program. 
  134.  The use of the program is at your own risk. 
  135.  By using (or attempting to use) the program you agree to this.
  136.  
  137. General
  138. -------
  139.  
  140.   RFFSORT is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  141.   
  142.   RFFSORT is (c) copyrighted by Loewy Ron, 1991, 92.
  143.  
  144.   RFFSORT is a shareware program, please register your copy. 
  145.   To register your copy of RFFSORT please refer to the supplied
  146.   RFFSORT.REG file. 
  147.  
  148.   Other programs distributed by ISoft D&M are described in the supplied  
  149.   PROGRAMS.TXT file.
  150.   
  151. Contact
  152. -------
  153.  
  154.   Please contact :
  155.  
  156.   ISoft D&M,  
  157.   P.O.B 5517
  158.   Coralville IA 52241,
  159.   U.S.A
  160.  
  161. Credits
  162. -------
  163.  
  164.   RFFSORT was written using Turbo-Pascal V6.0, 
  165.    a copyright of Borland International.
  166.  
  167.